home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / include / linux / videodev2.h < prev    next >
C/C++ Source or Header  |  2008-10-24  |  52KB  |  1,436 lines
  1. /*
  2.  *  Video for Linux Two header file
  3.  *
  4.  *  Copyright (C) 1999-2007 the contributors
  5.  *
  6.  *  This program is free software; you can redistribute it and/or modify
  7.  *  it under the terms of the GNU General Public License as published by
  8.  *  the Free Software Foundation; either version 2 of the License, or
  9.  *  (at your option) any later version.
  10.  *
  11.  *  This program is distributed in the hope that it will be useful,
  12.  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.  *  GNU General Public License for more details.
  15.  *
  16.  *  Alternatively you can redistribute this file under the terms of the
  17.  *  BSD license as stated below:
  18.  *
  19.  *  Redistribution and use in source and binary forms, with or without
  20.  *  modification, are permitted provided that the following conditions
  21.  *  are met:
  22.  *  1. Redistributions of source code must retain the above copyright
  23.  *     notice, this list of conditions and the following disclaimer.
  24.  *  2. Redistributions in binary form must reproduce the above copyright
  25.  *     notice, this list of conditions and the following disclaimer in
  26.  *     the documentation and/or other materials provided with the
  27.  *     distribution.
  28.  *  3. The names of its contributors may not be used to endorse or promote
  29.  *     products derived from this software without specific prior written
  30.  *     permission.
  31.  *
  32.  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  33.  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  34.  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  35.  *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  36.  *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  37.  *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
  38.  *  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  39.  *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  40.  *  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  41.  *  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  42.  *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  43.  *
  44.  *    Header file for v4l or V4L2 drivers and applications
  45.  * with public API.
  46.  * All kernel-specific stuff were moved to media/v4l2-dev.h, so
  47.  * no #if __KERNEL tests are allowed here
  48.  *
  49.  *    See http://linuxtv.org for more info
  50.  *
  51.  *    Author: Bill Dirks <bill@thedirks.org>
  52.  *        Justin Schoeman
  53.  *              Hans Verkuil <hverkuil@xs4all.nl>
  54.  *        et al.
  55.  */
  56. #ifndef __LINUX_VIDEODEV2_H
  57. #define __LINUX_VIDEODEV2_H
  58.  
  59. #include <sys/time.h>
  60.  
  61. #include <linux/ioctl.h>
  62. #include <linux/types.h>
  63.  
  64. /*
  65.  * Common stuff for both V4L1 and V4L2
  66.  * Moved from videodev.h
  67.  */
  68. #define VIDEO_MAX_FRAME               32
  69.  
  70.  
  71. /* These defines are V4L1 specific and should not be used with the V4L2 API!
  72.    They will be removed from this header in the future. */
  73.  
  74. #define VID_TYPE_CAPTURE    1    /* Can capture */
  75. #define VID_TYPE_TUNER        2    /* Can tune */
  76. #define VID_TYPE_TELETEXT    4    /* Does teletext */
  77. #define VID_TYPE_OVERLAY    8    /* Overlay onto frame buffer */
  78. #define VID_TYPE_CHROMAKEY    16    /* Overlay by chromakey */
  79. #define VID_TYPE_CLIPPING    32    /* Can clip */
  80. #define VID_TYPE_FRAMERAM    64    /* Uses the frame buffer memory */
  81. #define VID_TYPE_SCALES        128    /* Scalable */
  82. #define VID_TYPE_MONOCHROME    256    /* Monochrome only */
  83. #define VID_TYPE_SUBCAPTURE    512    /* Can capture subareas of the image */
  84. #define VID_TYPE_MPEG_DECODER    1024    /* Can decode MPEG streams */
  85. #define VID_TYPE_MPEG_ENCODER    2048    /* Can encode MPEG streams */
  86. #define VID_TYPE_MJPEG_DECODER    4096    /* Can decode MJPEG streams */
  87. #define VID_TYPE_MJPEG_ENCODER    8192    /* Can encode MJPEG streams */
  88.  
  89. /*
  90.  *    M I S C E L L A N E O U S
  91.  */
  92.  
  93. /*  Four-character-code (FOURCC) */
  94. #define v4l2_fourcc(a, b, c, d)\
  95.     ((__u32)(a) | ((__u32)(b) << 8) | ((__u32)(c) << 16) | ((__u32)(d) << 24))
  96.  
  97. /*
  98.  *    E N U M S
  99.  */
  100. enum v4l2_field {
  101.     V4L2_FIELD_ANY           = 0, /* driver can choose from none,
  102.                      top, bottom, interlaced
  103.                      depending on whatever it thinks
  104.                      is approximate ... */
  105.     V4L2_FIELD_NONE          = 1, /* this device has no fields ... */
  106.     V4L2_FIELD_TOP           = 2, /* top field only */
  107.     V4L2_FIELD_BOTTOM        = 3, /* bottom field only */
  108.     V4L2_FIELD_INTERLACED    = 4, /* both fields interlaced */
  109.     V4L2_FIELD_SEQ_TB        = 5, /* both fields sequential into one
  110.                      buffer, top-bottom order */
  111.     V4L2_FIELD_SEQ_BT        = 6, /* same as above + bottom-top order */
  112.     V4L2_FIELD_ALTERNATE     = 7, /* both fields alternating into
  113.                      separate buffers */
  114.     V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
  115.                      first and the top field is
  116.                      transmitted first */
  117.     V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
  118.                      first and the bottom field is
  119.                      transmitted first */
  120. };
  121. #define V4L2_FIELD_HAS_TOP(field)    \
  122.     ((field) == V4L2_FIELD_TOP     ||\
  123.      (field) == V4L2_FIELD_INTERLACED ||\
  124.      (field) == V4L2_FIELD_INTERLACED_TB ||\
  125.      (field) == V4L2_FIELD_INTERLACED_BT ||\
  126.      (field) == V4L2_FIELD_SEQ_TB    ||\
  127.      (field) == V4L2_FIELD_SEQ_BT)
  128. #define V4L2_FIELD_HAS_BOTTOM(field)    \
  129.     ((field) == V4L2_FIELD_BOTTOM     ||\
  130.      (field) == V4L2_FIELD_INTERLACED ||\
  131.      (field) == V4L2_FIELD_INTERLACED_TB ||\
  132.      (field) == V4L2_FIELD_INTERLACED_BT ||\
  133.      (field) == V4L2_FIELD_SEQ_TB    ||\
  134.      (field) == V4L2_FIELD_SEQ_BT)
  135. #define V4L2_FIELD_HAS_BOTH(field)    \
  136.     ((field) == V4L2_FIELD_INTERLACED ||\
  137.      (field) == V4L2_FIELD_INTERLACED_TB ||\
  138.      (field) == V4L2_FIELD_INTERLACED_BT ||\
  139.      (field) == V4L2_FIELD_SEQ_TB ||\
  140.      (field) == V4L2_FIELD_SEQ_BT)
  141.  
  142. enum v4l2_buf_type {
  143.     V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,
  144.     V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,
  145.     V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,
  146.     V4L2_BUF_TYPE_VBI_CAPTURE          = 4,
  147.     V4L2_BUF_TYPE_VBI_OUTPUT           = 5,
  148.     V4L2_BUF_TYPE_SLICED_VBI_CAPTURE   = 6,
  149.     V4L2_BUF_TYPE_SLICED_VBI_OUTPUT    = 7,
  150. #if 1
  151.     /* Experimental */
  152.     V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
  153. #endif
  154.     V4L2_BUF_TYPE_PRIVATE              = 0x80,
  155. };
  156.  
  157. enum v4l2_ctrl_type {
  158.     V4L2_CTRL_TYPE_INTEGER         = 1,
  159.     V4L2_CTRL_TYPE_BOOLEAN         = 2,
  160.     V4L2_CTRL_TYPE_MENU         = 3,
  161.     V4L2_CTRL_TYPE_BUTTON         = 4,
  162.     V4L2_CTRL_TYPE_INTEGER64     = 5,
  163.     V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
  164. };
  165.  
  166. enum v4l2_tuner_type {
  167.     V4L2_TUNER_RADIO         = 1,
  168.     V4L2_TUNER_ANALOG_TV         = 2,
  169.     V4L2_TUNER_DIGITAL_TV         = 3,
  170. };
  171.  
  172. enum v4l2_memory {
  173.     V4L2_MEMORY_MMAP             = 1,
  174.     V4L2_MEMORY_USERPTR          = 2,
  175.     V4L2_MEMORY_OVERLAY          = 3,
  176. };
  177.  
  178. /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
  179. enum v4l2_colorspace {
  180.     /* ITU-R 601 -- broadcast NTSC/PAL */
  181.     V4L2_COLORSPACE_SMPTE170M     = 1,
  182.  
  183.     /* 1125-Line (US) HDTV */
  184.     V4L2_COLORSPACE_SMPTE240M     = 2,
  185.  
  186.     /* HD and modern captures. */
  187.     V4L2_COLORSPACE_REC709        = 3,
  188.  
  189.     /* broken BT878 extents (601, luma range 16-253 instead of 16-235) */
  190.     V4L2_COLORSPACE_BT878         = 4,
  191.  
  192.     /* These should be useful.  Assume 601 extents. */
  193.     V4L2_COLORSPACE_470_SYSTEM_M  = 5,
  194.     V4L2_COLORSPACE_470_SYSTEM_BG = 6,
  195.  
  196.     /* I know there will be cameras that send this.  So, this is
  197.      * unspecified chromaticities and full 0-255 on each of the
  198.      * Y'CbCr components
  199.      */
  200.     V4L2_COLORSPACE_JPEG          = 7,
  201.  
  202.     /* For RGB colourspaces, this is probably a good start. */
  203.     V4L2_COLORSPACE_SRGB          = 8,
  204. };
  205.  
  206. enum v4l2_priority {
  207.     V4L2_PRIORITY_UNSET       = 0,  /* not initialized */
  208.     V4L2_PRIORITY_BACKGROUND  = 1,
  209.     V4L2_PRIORITY_INTERACTIVE = 2,
  210.     V4L2_PRIORITY_RECORD      = 3,
  211.     V4L2_PRIORITY_DEFAULT     = V4L2_PRIORITY_INTERACTIVE,
  212. };
  213.  
  214. struct v4l2_rect {
  215.     __s32   left;
  216.     __s32   top;
  217.     __s32   width;
  218.     __s32   height;
  219. };
  220.  
  221. struct v4l2_fract {
  222.     __u32   numerator;
  223.     __u32   denominator;
  224. };
  225.  
  226. /*
  227.  *    D R I V E R   C A P A B I L I T I E S
  228.  */
  229. struct v4l2_capability {
  230.     __u8    driver[16];    /* i.e. "bttv" */
  231.     __u8    card[32];    /* i.e. "Hauppauge WinTV" */
  232.     __u8    bus_info[32];    /* "PCI:" + pci_name(pci_dev) */
  233.     __u32   version;        /* should use KERNEL_VERSION() */
  234.     __u32    capabilities;    /* Device capabilities */
  235.     __u32    reserved[4];
  236. };
  237.  
  238. /* Values for 'capabilities' field */
  239. #define V4L2_CAP_VIDEO_CAPTURE        0x00000001  /* Is a video capture device */
  240. #define V4L2_CAP_VIDEO_OUTPUT        0x00000002  /* Is a video output device */
  241. #define V4L2_CAP_VIDEO_OVERLAY        0x00000004  /* Can do video overlay */
  242. #define V4L2_CAP_VBI_CAPTURE        0x00000010  /* Is a raw VBI capture device */
  243. #define V4L2_CAP_VBI_OUTPUT        0x00000020  /* Is a raw VBI output device */
  244. #define V4L2_CAP_SLICED_VBI_CAPTURE    0x00000040  /* Is a sliced VBI capture device */
  245. #define V4L2_CAP_SLICED_VBI_OUTPUT    0x00000080  /* Is a sliced VBI output device */
  246. #define V4L2_CAP_RDS_CAPTURE        0x00000100  /* RDS data capture */
  247. #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY    0x00000200  /* Can do video output overlay */
  248. #define V4L2_CAP_HW_FREQ_SEEK        0x00000400  /* Can do hardware frequency seek  */
  249.  
  250. #define V4L2_CAP_TUNER            0x00010000  /* has a tuner */
  251. #define V4L2_CAP_AUDIO            0x00020000  /* has audio support */
  252. #define V4L2_CAP_RADIO            0x00040000  /* is a radio device */
  253.  
  254. #define V4L2_CAP_READWRITE              0x01000000  /* read/write systemcalls */
  255. #define V4L2_CAP_ASYNCIO                0x02000000  /* async I/O */
  256. #define V4L2_CAP_STREAMING              0x04000000  /* streaming I/O ioctls */
  257.  
  258. /*
  259.  *    V I D E O   I M A G E   F O R M A T
  260.  */
  261. struct v4l2_pix_format {
  262.     __u32                 width;
  263.     __u32            height;
  264.     __u32            pixelformat;
  265.     enum v4l2_field      field;
  266.     __u32                bytesperline;    /* for padding, zero if unused */
  267.     __u32                  sizeimage;
  268.     enum v4l2_colorspace    colorspace;
  269.     __u32            priv;        /* private data, depends on pixelformat */
  270. };
  271.  
  272. /*      Pixel format         FOURCC                        depth  Description  */
  273. #define V4L2_PIX_FMT_RGB332  v4l2_fourcc('R', 'G', 'B', '1') /*  8  RGB-3-3-2     */
  274. #define V4L2_PIX_FMT_RGB444  v4l2_fourcc('R', '4', '4', '4') /* 16  xxxxrrrr ggggbbbb */
  275. #define V4L2_PIX_FMT_RGB555  v4l2_fourcc('R', 'G', 'B', 'O') /* 16  RGB-5-5-5     */
  276. #define V4L2_PIX_FMT_RGB565  v4l2_fourcc('R', 'G', 'B', 'P') /* 16  RGB-5-6-5     */
  277. #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R', 'G', 'B', 'Q') /* 16  RGB-5-5-5 BE  */
  278. #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R', 'G', 'B', 'R') /* 16  RGB-5-6-5 BE  */
  279. #define V4L2_PIX_FMT_BGR24   v4l2_fourcc('B', 'G', 'R', '3') /* 24  BGR-8-8-8     */
  280. #define V4L2_PIX_FMT_RGB24   v4l2_fourcc('R', 'G', 'B', '3') /* 24  RGB-8-8-8     */
  281. #define V4L2_PIX_FMT_BGR32   v4l2_fourcc('B', 'G', 'R', '4') /* 32  BGR-8-8-8-8   */
  282. #define V4L2_PIX_FMT_RGB32   v4l2_fourcc('R', 'G', 'B', '4') /* 32  RGB-8-8-8-8   */
  283. #define V4L2_PIX_FMT_GREY    v4l2_fourcc('G', 'R', 'E', 'Y') /*  8  Greyscale     */
  284. #define V4L2_PIX_FMT_Y16     v4l2_fourcc('Y', '1', '6', ' ') /* 16  Greyscale     */
  285. #define V4L2_PIX_FMT_PAL8    v4l2_fourcc('P', 'A', 'L', '8') /*  8  8-bit palette */
  286. #define V4L2_PIX_FMT_YVU410  v4l2_fourcc('Y', 'V', 'U', '9') /*  9  YVU 4:1:0     */
  287. #define V4L2_PIX_FMT_YVU420  v4l2_fourcc('Y', 'V', '1', '2') /* 12  YVU 4:2:0     */
  288. #define V4L2_PIX_FMT_YUYV    v4l2_fourcc('Y', 'U', 'Y', 'V') /* 16  YUV 4:2:2     */
  289. #define V4L2_PIX_FMT_UYVY    v4l2_fourcc('U', 'Y', 'V', 'Y') /* 16  YUV 4:2:2     */
  290. #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4', '2', '2', 'P') /* 16  YVU422 planar */
  291. #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4', '1', '1', 'P') /* 16  YVU411 planar */
  292. #define V4L2_PIX_FMT_Y41P    v4l2_fourcc('Y', '4', '1', 'P') /* 12  YUV 4:1:1     */
  293. #define V4L2_PIX_FMT_YUV444  v4l2_fourcc('Y', '4', '4', '4') /* 16  xxxxyyyy uuuuvvvv */
  294. #define V4L2_PIX_FMT_YUV555  v4l2_fourcc('Y', 'U', 'V', 'O') /* 16  YUV-5-5-5     */
  295. #define V4L2_PIX_FMT_YUV565  v4l2_fourcc('Y', 'U', 'V', 'P') /* 16  YUV-5-6-5     */
  296. #define V4L2_PIX_FMT_YUV32   v4l2_fourcc('Y', 'U', 'V', '4') /* 32  YUV-8-8-8-8   */
  297.  
  298. /* two planes -- one Y, one Cr + Cb interleaved  */
  299. #define V4L2_PIX_FMT_NV12    v4l2_fourcc('N', 'V', '1', '2') /* 12  Y/CbCr 4:2:0  */
  300. #define V4L2_PIX_FMT_NV21    v4l2_fourcc('N', 'V', '2', '1') /* 12  Y/CrCb 4:2:0  */
  301.  
  302. /*  The following formats are not defined in the V4L2 specification */
  303. #define V4L2_PIX_FMT_YUV410  v4l2_fourcc('Y', 'U', 'V', '9') /*  9  YUV 4:1:0     */
  304. #define V4L2_PIX_FMT_YUV420  v4l2_fourcc('Y', 'U', '1', '2') /* 12  YUV 4:2:0     */
  305. #define V4L2_PIX_FMT_YYUV    v4l2_fourcc('Y', 'Y', 'U', 'V') /* 16  YUV 4:2:2     */
  306. #define V4L2_PIX_FMT_HI240   v4l2_fourcc('H', 'I', '2', '4') /*  8  8-bit color   */
  307. #define V4L2_PIX_FMT_HM12    v4l2_fourcc('H', 'M', '1', '2') /*  8  YUV 4:2:0 16x16 macroblocks */
  308.  
  309. /* see http://www.siliconimaging.com/RGB%20Bayer.htm */
  310. #define V4L2_PIX_FMT_SBGGR8  v4l2_fourcc('B', 'A', '8', '1') /*  8  BGBG.. GRGR.. */
  311. #define V4L2_PIX_FMT_SGBRG8  v4l2_fourcc('G', 'B', 'R', 'G') /*  8  GBGB.. RGRG.. */
  312. #define V4L2_PIX_FMT_SBGGR16 v4l2_fourcc('B', 'Y', 'R', '2') /* 16  BGBG.. GRGR.. */
  313.  
  314. /* compressed formats */
  315. #define V4L2_PIX_FMT_MJPEG    v4l2_fourcc('M', 'J', 'P', 'G') /* Motion-JPEG   */
  316. #define V4L2_PIX_FMT_JPEG     v4l2_fourcc('J', 'P', 'E', 'G') /* JFIF JPEG     */
  317. #define V4L2_PIX_FMT_DV       v4l2_fourcc('d', 'v', 's', 'd') /* 1394          */
  318. #define V4L2_PIX_FMT_MPEG     v4l2_fourcc('M', 'P', 'E', 'G') /* MPEG-1/2/4    */
  319.  
  320. /*  Vendor-specific formats   */
  321. #define V4L2_PIX_FMT_WNVA     v4l2_fourcc('W', 'N', 'V', 'A') /* Winnov hw compress */
  322. #define V4L2_PIX_FMT_SN9C10X  v4l2_fourcc('S', '9', '1', '0') /* SN9C10x compression */
  323. #define V4L2_PIX_FMT_PWC1     v4l2_fourcc('P', 'W', 'C', '1') /* pwc older webcam */
  324. #define V4L2_PIX_FMT_PWC2     v4l2_fourcc('P', 'W', 'C', '2') /* pwc newer webcam */
  325. #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E', '6', '2', '5') /* ET61X251 compression */
  326. #define V4L2_PIX_FMT_SPCA501  v4l2_fourcc('S', '5', '0', '1') /* YUYV per line */
  327. #define V4L2_PIX_FMT_SPCA505  v4l2_fourcc('S', '5', '0', '5') /* YYUV per line */
  328. #define V4L2_PIX_FMT_SPCA508  v4l2_fourcc('S', '5', '0', '8') /* YUVY per line */
  329. #define V4L2_PIX_FMT_SPCA561  v4l2_fourcc('S', '5', '6', '1') /* compressed GBRG bayer */
  330. #define V4L2_PIX_FMT_PAC207   v4l2_fourcc('P', '2', '0', '7') /* compressed BGGR bayer */
  331. #define V4L2_PIX_FMT_PJPG     v4l2_fourcc('P', 'J', 'P', 'G') /* Pixart 73xx JPEG */
  332. #define V4L2_PIX_FMT_YVYU    v4l2_fourcc('Y', 'V', 'Y', 'U') /* 16  YVU 4:2:2     */
  333.  
  334. /*
  335.  *    F O R M A T   E N U M E R A T I O N
  336.  */
  337. struct v4l2_fmtdesc {
  338.     __u32            index;             /* Format number      */
  339.     enum v4l2_buf_type  type;              /* buffer type        */
  340.     __u32               flags;
  341.     __u8            description[32];   /* Description string */
  342.     __u32            pixelformat;       /* Format fourcc      */
  343.     __u32            reserved[4];
  344. };
  345.  
  346. #define V4L2_FMT_FLAG_COMPRESSED 0x0001
  347.  
  348. #if 1
  349.     /* Experimental Frame Size and frame rate enumeration */
  350. /*
  351.  *    F R A M E   S I Z E   E N U M E R A T I O N
  352.  */
  353. enum v4l2_frmsizetypes {
  354.     V4L2_FRMSIZE_TYPE_DISCRETE    = 1,
  355.     V4L2_FRMSIZE_TYPE_CONTINUOUS    = 2,
  356.     V4L2_FRMSIZE_TYPE_STEPWISE    = 3,
  357. };
  358.  
  359. struct v4l2_frmsize_discrete {
  360.     __u32            width;        /* Frame width [pixel] */
  361.     __u32            height;        /* Frame height [pixel] */
  362. };
  363.  
  364. struct v4l2_frmsize_stepwise {
  365.     __u32            min_width;    /* Minimum frame width [pixel] */
  366.     __u32            max_width;    /* Maximum frame width [pixel] */
  367.     __u32            step_width;    /* Frame width step size [pixel] */
  368.     __u32            min_height;    /* Minimum frame height [pixel] */
  369.     __u32            max_height;    /* Maximum frame height [pixel] */
  370.     __u32            step_height;    /* Frame height step size [pixel] */
  371. };
  372.  
  373. struct v4l2_frmsizeenum {
  374.     __u32            index;        /* Frame size number */
  375.     __u32            pixel_format;    /* Pixel format */
  376.     __u32            type;        /* Frame size type the device supports. */
  377.  
  378.     union {                    /* Frame size */
  379.         struct v4l2_frmsize_discrete    discrete;
  380.         struct v4l2_frmsize_stepwise    stepwise;
  381.     };
  382.  
  383.     __u32   reserved[2];            /* Reserved space for future use */
  384. };
  385.  
  386. /*
  387.  *    F R A M E   R A T E   E N U M E R A T I O N
  388.  */
  389. enum v4l2_frmivaltypes {
  390.     V4L2_FRMIVAL_TYPE_DISCRETE    = 1,
  391.     V4L2_FRMIVAL_TYPE_CONTINUOUS    = 2,
  392.     V4L2_FRMIVAL_TYPE_STEPWISE    = 3,
  393. };
  394.  
  395. struct v4l2_frmival_stepwise {
  396.     struct v4l2_fract    min;        /* Minimum frame interval [s] */
  397.     struct v4l2_fract    max;        /* Maximum frame interval [s] */
  398.     struct v4l2_fract    step;        /* Frame interval step size [s] */
  399. };
  400.  
  401. struct v4l2_frmivalenum {
  402.     __u32            index;        /* Frame format index */
  403.     __u32            pixel_format;    /* Pixel format */
  404.     __u32            width;        /* Frame width */
  405.     __u32            height;        /* Frame height */
  406.     __u32            type;        /* Frame interval type the device supports. */
  407.  
  408.     union {                    /* Frame interval */
  409.         struct v4l2_fract        discrete;
  410.         struct v4l2_frmival_stepwise    stepwise;
  411.     };
  412.  
  413.     __u32    reserved[2];            /* Reserved space for future use */
  414. };
  415. #endif
  416.  
  417. /*
  418.  *    T I M E C O D E
  419.  */
  420. struct v4l2_timecode {
  421.     __u32    type;
  422.     __u32    flags;
  423.     __u8    frames;
  424.     __u8    seconds;
  425.     __u8    minutes;
  426.     __u8    hours;
  427.     __u8    userbits[4];
  428. };
  429.  
  430. /*  Type  */
  431. #define V4L2_TC_TYPE_24FPS        1
  432. #define V4L2_TC_TYPE_25FPS        2
  433. #define V4L2_TC_TYPE_30FPS        3
  434. #define V4L2_TC_TYPE_50FPS        4
  435. #define V4L2_TC_TYPE_60FPS        5
  436.  
  437. /*  Flags  */
  438. #define V4L2_TC_FLAG_DROPFRAME        0x0001 /* "drop-frame" mode */
  439. #define V4L2_TC_FLAG_COLORFRAME        0x0002
  440. #define V4L2_TC_USERBITS_field        0x000C
  441. #define V4L2_TC_USERBITS_USERDEFINED    0x0000
  442. #define V4L2_TC_USERBITS_8BITCHARS    0x0008
  443. /* The above is based on SMPTE timecodes */
  444.  
  445. struct v4l2_jpegcompression {
  446.     int quality;
  447.  
  448.     int  APPn;              /* Number of APP segment to be written,
  449.                  * must be 0..15 */
  450.     int  APP_len;           /* Length of data in JPEG APPn segment */
  451.     char APP_data[60];      /* Data in the JPEG APPn segment. */
  452.  
  453.     int  COM_len;           /* Length of data in JPEG COM segment */
  454.     char COM_data[60];      /* Data in JPEG COM segment */
  455.  
  456.     __u32 jpeg_markers;     /* Which markers should go into the JPEG
  457.                  * output. Unless you exactly know what
  458.                  * you do, leave them untouched.
  459.                  * Inluding less markers will make the
  460.                  * resulting code smaller, but there will
  461.                  * be fewer aplications which can read it.
  462.                  * The presence of the APP and COM marker
  463.                  * is influenced by APP_len and COM_len
  464.                  * ONLY, not by this property! */
  465.  
  466. #define V4L2_JPEG_MARKER_DHT (1<<3)    /* Define Huffman Tables */
  467. #define V4L2_JPEG_MARKER_DQT (1<<4)    /* Define Quantization Tables */
  468. #define V4L2_JPEG_MARKER_DRI (1<<5)    /* Define Restart Interval */
  469. #define V4L2_JPEG_MARKER_COM (1<<6)    /* Comment segment */
  470. #define V4L2_JPEG_MARKER_APP (1<<7)    /* App segment, driver will
  471.                     * allways use APP0 */
  472. };
  473.  
  474. /*
  475.  *    M E M O R Y - M A P P I N G   B U F F E R S
  476.  */
  477. struct v4l2_requestbuffers {
  478.     __u32            count;
  479.     enum v4l2_buf_type      type;
  480.     enum v4l2_memory        memory;
  481.     __u32            reserved[2];
  482. };
  483.  
  484. struct v4l2_buffer {
  485.     __u32            index;
  486.     enum v4l2_buf_type      type;
  487.     __u32            bytesused;
  488.     __u32            flags;
  489.     enum v4l2_field        field;
  490.     struct timeval        timestamp;
  491.     struct v4l2_timecode    timecode;
  492.     __u32            sequence;
  493.  
  494.     /* memory location */
  495.     enum v4l2_memory        memory;
  496.     union {
  497.         __u32           offset;
  498.         unsigned long   userptr;
  499.     } m;
  500.     __u32            length;
  501.     __u32            input;
  502.     __u32            reserved;
  503. };
  504.  
  505. /*  Flags for 'flags' field */
  506. #define V4L2_BUF_FLAG_MAPPED    0x0001  /* Buffer is mapped (flag) */
  507. #define V4L2_BUF_FLAG_QUEUED    0x0002    /* Buffer is queued for processing */
  508. #define V4L2_BUF_FLAG_DONE    0x0004    /* Buffer is ready */
  509. #define V4L2_BUF_FLAG_KEYFRAME    0x0008    /* Image is a keyframe (I-frame) */
  510. #define V4L2_BUF_FLAG_PFRAME    0x0010    /* Image is a P-frame */
  511. #define V4L2_BUF_FLAG_BFRAME    0x0020    /* Image is a B-frame */
  512. #define V4L2_BUF_FLAG_TIMECODE    0x0100    /* timecode field is valid */
  513. #define V4L2_BUF_FLAG_INPUT     0x0200  /* input field is valid */
  514.  
  515. /*
  516.  *    O V E R L A Y   P R E V I E W
  517.  */
  518. struct v4l2_framebuffer {
  519.     __u32            capability;
  520.     __u32            flags;
  521. /* FIXME: in theory we should pass something like PCI device + memory
  522.  * region + offset instead of some physical address */
  523.     void                    *base;
  524.     struct v4l2_pix_format    fmt;
  525. };
  526. /*  Flags for the 'capability' field. Read only */
  527. #define V4L2_FBUF_CAP_EXTERNOVERLAY    0x0001
  528. #define V4L2_FBUF_CAP_CHROMAKEY        0x0002
  529. #define V4L2_FBUF_CAP_LIST_CLIPPING     0x0004
  530. #define V4L2_FBUF_CAP_BITMAP_CLIPPING    0x0008
  531. #define V4L2_FBUF_CAP_LOCAL_ALPHA    0x0010
  532. #define V4L2_FBUF_CAP_GLOBAL_ALPHA    0x0020
  533. #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA    0x0040
  534. /*  Flags for the 'flags' field. */
  535. #define V4L2_FBUF_FLAG_PRIMARY        0x0001
  536. #define V4L2_FBUF_FLAG_OVERLAY        0x0002
  537. #define V4L2_FBUF_FLAG_CHROMAKEY    0x0004
  538. #define V4L2_FBUF_FLAG_LOCAL_ALPHA    0x0008
  539. #define V4L2_FBUF_FLAG_GLOBAL_ALPHA    0x0010
  540. #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA    0x0020
  541.  
  542. struct v4l2_clip {
  543.     struct v4l2_rect        c;
  544.     struct v4l2_clip    *next;
  545. };
  546.  
  547. struct v4l2_window {
  548.     struct v4l2_rect        w;
  549.     enum v4l2_field      field;
  550.     __u32            chromakey;
  551.     struct v4l2_clip    *clips;
  552.     __u32            clipcount;
  553.     void            *bitmap;
  554.     __u8                    global_alpha;
  555. };
  556.  
  557. /*
  558.  *    C A P T U R E   P A R A M E T E R S
  559.  */
  560. struct v4l2_captureparm {
  561.     __u32           capability;      /*  Supported modes */
  562.     __u32           capturemode;      /*  Current mode */
  563.     struct v4l2_fract  timeperframe;  /*  Time per frame in .1us units */
  564.     __u32           extendedmode;  /*  Driver-specific extensions */
  565.     __u32              readbuffers;   /*  # of buffers for read */
  566.     __u32           reserved[4];
  567. };
  568.  
  569. /*  Flags for 'capability' and 'capturemode' fields */
  570. #define V4L2_MODE_HIGHQUALITY    0x0001    /*  High quality imaging mode */
  571. #define V4L2_CAP_TIMEPERFRAME    0x1000    /*  timeperframe field is supported */
  572.  
  573. struct v4l2_outputparm {
  574.     __u32           capability;     /*  Supported modes */
  575.     __u32           outputmode;     /*  Current mode */
  576.     struct v4l2_fract  timeperframe; /*  Time per frame in seconds */
  577.     __u32           extendedmode; /*  Driver-specific extensions */
  578.     __u32              writebuffers; /*  # of buffers for write */
  579.     __u32           reserved[4];
  580. };
  581.  
  582. /*
  583.  *    I N P U T   I M A G E   C R O P P I N G
  584.  */
  585. struct v4l2_cropcap {
  586.     enum v4l2_buf_type      type;
  587.     struct v4l2_rect        bounds;
  588.     struct v4l2_rect        defrect;
  589.     struct v4l2_fract       pixelaspect;
  590. };
  591.  
  592. struct v4l2_crop {
  593.     enum v4l2_buf_type      type;
  594.     struct v4l2_rect        c;
  595. };
  596.  
  597. /*
  598.  *      A N A L O G   V I D E O   S T A N D A R D
  599.  */
  600.  
  601. typedef __u64 v4l2_std_id;
  602.  
  603. /* one bit for each */
  604. #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
  605. #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
  606. #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
  607. #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
  608. #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
  609. #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
  610. #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
  611. #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
  612.  
  613. #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
  614. #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
  615. #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
  616. #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
  617.  
  618. #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)
  619. #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)
  620. #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
  621. #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)
  622.  
  623. #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
  624. #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
  625. #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
  626. #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
  627. #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
  628. #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
  629. #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
  630. #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
  631.  
  632. /* ATSC/HDTV */
  633. #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
  634. #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
  635.  
  636. /* FIXME:
  637.    Although std_id is 64 bits, there is an issue on PPC32 architecture that
  638.    makes switch(__u64) to break. So, there's a hack on v4l2-common.c rounding
  639.    this value to 32 bits.
  640.    As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
  641.    it should work fine. However, if needed to add more than two standards,
  642.    v4l2-common.c should be fixed.
  643.  */
  644.  
  645. /* some merged standards */
  646. #define V4L2_STD_MN    (V4L2_STD_PAL_M|V4L2_STD_PAL_N|V4L2_STD_PAL_Nc|V4L2_STD_NTSC)
  647. #define V4L2_STD_B    (V4L2_STD_PAL_B|V4L2_STD_PAL_B1|V4L2_STD_SECAM_B)
  648. #define V4L2_STD_GH    (V4L2_STD_PAL_G|V4L2_STD_PAL_H|V4L2_STD_SECAM_G|V4L2_STD_SECAM_H)
  649. #define V4L2_STD_DK    (V4L2_STD_PAL_DK|V4L2_STD_SECAM_DK)
  650.  
  651. /* some common needed stuff */
  652. #define V4L2_STD_PAL_BG        (V4L2_STD_PAL_B        |\
  653.                  V4L2_STD_PAL_B1    |\
  654.                  V4L2_STD_PAL_G)
  655. #define V4L2_STD_PAL_DK        (V4L2_STD_PAL_D        |\
  656.                  V4L2_STD_PAL_D1    |\
  657.                  V4L2_STD_PAL_K)
  658. #define V4L2_STD_PAL        (V4L2_STD_PAL_BG    |\
  659.                  V4L2_STD_PAL_DK    |\
  660.                  V4L2_STD_PAL_H        |\
  661.                  V4L2_STD_PAL_I)
  662. #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M    |\
  663.                  V4L2_STD_NTSC_M_JP     |\
  664.                  V4L2_STD_NTSC_M_KR)
  665. #define V4L2_STD_SECAM_DK          (V4L2_STD_SECAM_D    |\
  666.                  V4L2_STD_SECAM_K    |\
  667.                  V4L2_STD_SECAM_K1)
  668. #define V4L2_STD_SECAM        (V4L2_STD_SECAM_B    |\
  669.                  V4L2_STD_SECAM_G    |\
  670.                  V4L2_STD_SECAM_H    |\
  671.                  V4L2_STD_SECAM_DK    |\
  672.                  V4L2_STD_SECAM_L       |\
  673.                  V4L2_STD_SECAM_LC)
  674.  
  675. #define V4L2_STD_525_60        (V4L2_STD_PAL_M        |\
  676.                  V4L2_STD_PAL_60    |\
  677.                  V4L2_STD_NTSC        |\
  678.                  V4L2_STD_NTSC_443)
  679. #define V4L2_STD_625_50        (V4L2_STD_PAL        |\
  680.                  V4L2_STD_PAL_N        |\
  681.                  V4L2_STD_PAL_Nc    |\
  682.                  V4L2_STD_SECAM)
  683. #define V4L2_STD_ATSC           (V4L2_STD_ATSC_8_VSB    |\
  684.                  V4L2_STD_ATSC_16_VSB)
  685.  
  686. #define V4L2_STD_UNKNOWN        0
  687. #define V4L2_STD_ALL            (V4L2_STD_525_60    |\
  688.                  V4L2_STD_625_50)
  689.  
  690. struct v4l2_standard {
  691.     __u32             index;
  692.     v4l2_std_id          id;
  693.     __u8             name[24];
  694.     struct v4l2_fract    frameperiod; /* Frames, not fields */
  695.     __u32             framelines;
  696.     __u32             reserved[4];
  697. };
  698.  
  699. /*
  700.  *    V I D E O   I N P U T S
  701.  */
  702. struct v4l2_input {
  703.     __u32         index;        /*  Which input */
  704.     __u8         name[32];        /*  Label */
  705.     __u32         type;        /*  Type of input */
  706.     __u32         audioset;        /*  Associated audios (bitfield) */
  707.     __u32        tuner;             /*  Associated tuner */
  708.     v4l2_std_id  std;
  709.     __u32         status;
  710.     __u32         reserved[4];
  711. };
  712.  
  713. /*  Values for the 'type' field */
  714. #define V4L2_INPUT_TYPE_TUNER        1
  715. #define V4L2_INPUT_TYPE_CAMERA        2
  716.  
  717. /* field 'status' - general */
  718. #define V4L2_IN_ST_NO_POWER    0x00000001  /* Attached device is off */
  719. #define V4L2_IN_ST_NO_SIGNAL   0x00000002
  720. #define V4L2_IN_ST_NO_COLOR    0x00000004
  721.  
  722. /* field 'status' - analog */
  723. #define V4L2_IN_ST_NO_H_LOCK   0x00000100  /* No horizontal sync lock */
  724. #define V4L2_IN_ST_COLOR_KILL  0x00000200  /* Color killer is active */
  725.  
  726. /* field 'status' - digital */
  727. #define V4L2_IN_ST_NO_SYNC     0x00010000  /* No synchronization lock */
  728. #define V4L2_IN_ST_NO_EQU      0x00020000  /* No equalizer lock */
  729. #define V4L2_IN_ST_NO_CARRIER  0x00040000  /* Carrier recovery failed */
  730.  
  731. /* field 'status' - VCR and set-top box */
  732. #define V4L2_IN_ST_MACROVISION 0x01000000  /* Macrovision detected */
  733. #define V4L2_IN_ST_NO_ACCESS   0x02000000  /* Conditional access denied */
  734. #define V4L2_IN_ST_VTR         0x04000000  /* VTR time constant */
  735.  
  736. /*
  737.  *    V I D E O   O U T P U T S
  738.  */
  739. struct v4l2_output {
  740.     __u32         index;        /*  Which output */
  741.     __u8         name[32];        /*  Label */
  742.     __u32         type;        /*  Type of output */
  743.     __u32         audioset;        /*  Associated audios (bitfield) */
  744.     __u32         modulator;         /*  Associated modulator */
  745.     v4l2_std_id  std;
  746.     __u32         reserved[4];
  747. };
  748. /*  Values for the 'type' field */
  749. #define V4L2_OUTPUT_TYPE_MODULATOR        1
  750. #define V4L2_OUTPUT_TYPE_ANALOG            2
  751. #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY    3
  752.  
  753. /*
  754.  *    C O N T R O L S
  755.  */
  756. struct v4l2_control {
  757.     __u32             id;
  758.     __s32             value;
  759. };
  760.  
  761. struct v4l2_ext_control {
  762.     __u32 id;
  763.     __u32 reserved2[2];
  764.     union {
  765.         __s32 value;
  766.         __s64 value64;
  767.         void *reserved;
  768.     };
  769. } __attribute__ ((packed));
  770.  
  771. struct v4l2_ext_controls {
  772.     __u32 ctrl_class;
  773.     __u32 count;
  774.     __u32 error_idx;
  775.     __u32 reserved[2];
  776.     struct v4l2_ext_control *controls;
  777. };
  778.  
  779. /*  Values for ctrl_class field */
  780. #define V4L2_CTRL_CLASS_USER 0x00980000    /* Old-style 'user' controls */
  781. #define V4L2_CTRL_CLASS_MPEG 0x00990000    /* MPEG-compression controls */
  782. #define V4L2_CTRL_CLASS_CAMERA 0x009a0000    /* Camera class controls */
  783.  
  784. #define V4L2_CTRL_ID_MASK            (0x0fffffff)
  785. #define V4L2_CTRL_ID2CLASS(id)    ((id) & 0x0fff0000UL)
  786. #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
  787.  
  788. /*  Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
  789. struct v4l2_queryctrl {
  790.     __u32             id;
  791.     enum v4l2_ctrl_type  type;
  792.     __u8             name[32];    /* Whatever */
  793.     __s32             minimum;    /* Note signedness */
  794.     __s32             maximum;
  795.     __s32             step;
  796.     __s32             default_value;
  797.     __u32                flags;
  798.     __u32             reserved[2];
  799. };
  800.  
  801. /*  Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
  802. struct v4l2_querymenu {
  803.     __u32        id;
  804.     __u32        index;
  805.     __u8        name[32];    /* Whatever */
  806.     __u32        reserved;
  807. };
  808.  
  809. /*  Control flags  */
  810. #define V4L2_CTRL_FLAG_DISABLED        0x0001
  811. #define V4L2_CTRL_FLAG_GRABBED        0x0002
  812. #define V4L2_CTRL_FLAG_READ_ONLY     0x0004
  813. #define V4L2_CTRL_FLAG_UPDATE         0x0008
  814. #define V4L2_CTRL_FLAG_INACTIVE     0x0010
  815. #define V4L2_CTRL_FLAG_SLIDER         0x0020
  816.  
  817. /*  Query flag, to be ORed with the control ID */
  818. #define V4L2_CTRL_FLAG_NEXT_CTRL    0x80000000
  819.  
  820. /*  User-class control IDs defined by V4L2 */
  821. #define V4L2_CID_BASE            (V4L2_CTRL_CLASS_USER | 0x900)
  822. #define V4L2_CID_USER_BASE         V4L2_CID_BASE
  823. /*  IDs reserved for driver specific controls */
  824. #define V4L2_CID_PRIVATE_BASE        0x08000000
  825.  
  826. #define V4L2_CID_USER_CLASS         (V4L2_CTRL_CLASS_USER | 1)
  827. #define V4L2_CID_BRIGHTNESS        (V4L2_CID_BASE+0)
  828. #define V4L2_CID_CONTRAST        (V4L2_CID_BASE+1)
  829. #define V4L2_CID_SATURATION        (V4L2_CID_BASE+2)
  830. #define V4L2_CID_HUE            (V4L2_CID_BASE+3)
  831. #define V4L2_CID_AUDIO_VOLUME        (V4L2_CID_BASE+5)
  832. #define V4L2_CID_AUDIO_BALANCE        (V4L2_CID_BASE+6)
  833. #define V4L2_CID_AUDIO_BASS        (V4L2_CID_BASE+7)
  834. #define V4L2_CID_AUDIO_TREBLE        (V4L2_CID_BASE+8)
  835. #define V4L2_CID_AUDIO_MUTE        (V4L2_CID_BASE+9)
  836. #define V4L2_CID_AUDIO_LOUDNESS        (V4L2_CID_BASE+10)
  837. #define V4L2_CID_BLACK_LEVEL        (V4L2_CID_BASE+11) /* Deprecated */
  838. #define V4L2_CID_AUTO_WHITE_BALANCE    (V4L2_CID_BASE+12)
  839. #define V4L2_CID_DO_WHITE_BALANCE    (V4L2_CID_BASE+13)
  840. #define V4L2_CID_RED_BALANCE        (V4L2_CID_BASE+14)
  841. #define V4L2_CID_BLUE_BALANCE        (V4L2_CID_BASE+15)
  842. #define V4L2_CID_GAMMA            (V4L2_CID_BASE+16)
  843. #define V4L2_CID_WHITENESS        (V4L2_CID_GAMMA) /* Deprecated */
  844. #define V4L2_CID_EXPOSURE        (V4L2_CID_BASE+17)
  845. #define V4L2_CID_AUTOGAIN        (V4L2_CID_BASE+18)
  846. #define V4L2_CID_GAIN            (V4L2_CID_BASE+19)
  847. #define V4L2_CID_HFLIP            (V4L2_CID_BASE+20)
  848. #define V4L2_CID_VFLIP            (V4L2_CID_BASE+21)
  849.  
  850. /* Deprecated; use V4L2_CID_PAN_RESET and V4L2_CID_TILT_RESET */
  851. #define V4L2_CID_HCENTER        (V4L2_CID_BASE+22)
  852. #define V4L2_CID_VCENTER        (V4L2_CID_BASE+23)
  853.  
  854. #define V4L2_CID_POWER_LINE_FREQUENCY    (V4L2_CID_BASE+24)
  855. enum v4l2_power_line_frequency {
  856.     V4L2_CID_POWER_LINE_FREQUENCY_DISABLED    = 0,
  857.     V4L2_CID_POWER_LINE_FREQUENCY_50HZ    = 1,
  858.     V4L2_CID_POWER_LINE_FREQUENCY_60HZ    = 2,
  859. };
  860. #define V4L2_CID_HUE_AUTO            (V4L2_CID_BASE+25)
  861. #define V4L2_CID_WHITE_BALANCE_TEMPERATURE    (V4L2_CID_BASE+26)
  862. #define V4L2_CID_SHARPNESS            (V4L2_CID_BASE+27)
  863. #define V4L2_CID_BACKLIGHT_COMPENSATION     (V4L2_CID_BASE+28)
  864. #define V4L2_CID_CHROMA_AGC                     (V4L2_CID_BASE+29)
  865. #define V4L2_CID_COLOR_KILLER                   (V4L2_CID_BASE+30)
  866. /* last CID + 1 */
  867. #define V4L2_CID_LASTP1                         (V4L2_CID_BASE+31)
  868.  
  869. /*  MPEG-class control IDs defined by V4L2 */
  870. #define V4L2_CID_MPEG_BASE             (V4L2_CTRL_CLASS_MPEG | 0x900)
  871. #define V4L2_CID_MPEG_CLASS             (V4L2_CTRL_CLASS_MPEG | 1)
  872.  
  873. /*  MPEG streams */
  874. #define V4L2_CID_MPEG_STREAM_TYPE         (V4L2_CID_MPEG_BASE+0)
  875. enum v4l2_mpeg_stream_type {
  876.     V4L2_MPEG_STREAM_TYPE_MPEG2_PS   = 0, /* MPEG-2 program stream */
  877.     V4L2_MPEG_STREAM_TYPE_MPEG2_TS   = 1, /* MPEG-2 transport stream */
  878.     V4L2_MPEG_STREAM_TYPE_MPEG1_SS   = 2, /* MPEG-1 system stream */
  879.     V4L2_MPEG_STREAM_TYPE_MPEG2_DVD  = 3, /* MPEG-2 DVD-compatible stream */
  880.     V4L2_MPEG_STREAM_TYPE_MPEG1_VCD  = 4, /* MPEG-1 VCD-compatible stream */
  881.     V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
  882. };
  883. #define V4L2_CID_MPEG_STREAM_PID_PMT         (V4L2_CID_MPEG_BASE+1)
  884. #define V4L2_CID_MPEG_STREAM_PID_AUDIO         (V4L2_CID_MPEG_BASE+2)
  885. #define V4L2_CID_MPEG_STREAM_PID_VIDEO         (V4L2_CID_MPEG_BASE+3)
  886. #define V4L2_CID_MPEG_STREAM_PID_PCR         (V4L2_CID_MPEG_BASE+4)
  887. #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO     (V4L2_CID_MPEG_BASE+5)
  888. #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO     (V4L2_CID_MPEG_BASE+6)
  889. #define V4L2_CID_MPEG_STREAM_VBI_FMT         (V4L2_CID_MPEG_BASE+7)
  890. enum v4l2_mpeg_stream_vbi_fmt {
  891.     V4L2_MPEG_STREAM_VBI_FMT_NONE = 0,  /* No VBI in the MPEG stream */
  892.     V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1,  /* VBI in private packets, IVTV format */
  893. };
  894.  
  895. /*  MPEG audio */
  896. #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ     (V4L2_CID_MPEG_BASE+100)
  897. enum v4l2_mpeg_audio_sampling_freq {
  898.     V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
  899.     V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
  900.     V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
  901. };
  902. #define V4L2_CID_MPEG_AUDIO_ENCODING         (V4L2_CID_MPEG_BASE+101)
  903. enum v4l2_mpeg_audio_encoding {
  904.     V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
  905.     V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
  906.     V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
  907. };
  908. #define V4L2_CID_MPEG_AUDIO_L1_BITRATE         (V4L2_CID_MPEG_BASE+102)
  909. enum v4l2_mpeg_audio_l1_bitrate {
  910.     V4L2_MPEG_AUDIO_L1_BITRATE_32K  = 0,
  911.     V4L2_MPEG_AUDIO_L1_BITRATE_64K  = 1,
  912.     V4L2_MPEG_AUDIO_L1_BITRATE_96K  = 2,
  913.     V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
  914.     V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
  915.     V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
  916.     V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
  917.     V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
  918.     V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
  919.     V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
  920.     V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
  921.     V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
  922.     V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
  923.     V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
  924. };
  925. #define V4L2_CID_MPEG_AUDIO_L2_BITRATE         (V4L2_CID_MPEG_BASE+103)
  926. enum v4l2_mpeg_audio_l2_bitrate {
  927.     V4L2_MPEG_AUDIO_L2_BITRATE_32K  = 0,
  928.     V4L2_MPEG_AUDIO_L2_BITRATE_48K  = 1,
  929.     V4L2_MPEG_AUDIO_L2_BITRATE_56K  = 2,
  930.     V4L2_MPEG_AUDIO_L2_BITRATE_64K  = 3,
  931.     V4L2_MPEG_AUDIO_L2_BITRATE_80K  = 4,
  932.     V4L2_MPEG_AUDIO_L2_BITRATE_96K  = 5,
  933.     V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
  934.     V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
  935.     V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
  936.     V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
  937.     V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
  938.     V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
  939.     V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
  940.     V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
  941. };
  942. #define V4L2_CID_MPEG_AUDIO_L3_BITRATE         (V4L2_CID_MPEG_BASE+104)
  943. enum v4l2_mpeg_audio_l3_bitrate {
  944.     V4L2_MPEG_AUDIO_L3_BITRATE_32K  = 0,
  945.     V4L2_MPEG_AUDIO_L3_BITRATE_40K  = 1,
  946.     V4L2_MPEG_AUDIO_L3_BITRATE_48K  = 2,
  947.     V4L2_MPEG_AUDIO_L3_BITRATE_56K  = 3,
  948.     V4L2_MPEG_AUDIO_L3_BITRATE_64K  = 4,
  949.     V4L2_MPEG_AUDIO_L3_BITRATE_80K  = 5,
  950.     V4L2_MPEG_AUDIO_L3_BITRATE_96K  = 6,
  951.     V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
  952.     V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
  953.     V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
  954.     V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
  955.     V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
  956.     V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
  957.     V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
  958. };
  959. #define V4L2_CID_MPEG_AUDIO_MODE         (V4L2_CID_MPEG_BASE+105)
  960. enum v4l2_mpeg_audio_mode {
  961.     V4L2_MPEG_AUDIO_MODE_STEREO       = 0,
  962.     V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
  963.     V4L2_MPEG_AUDIO_MODE_DUAL         = 2,
  964.     V4L2_MPEG_AUDIO_MODE_MONO         = 3,
  965. };
  966. #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION     (V4L2_CID_MPEG_BASE+106)
  967. enum v4l2_mpeg_audio_mode_extension {
  968.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4  = 0,
  969.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8  = 1,
  970.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
  971.     V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
  972. };
  973. #define V4L2_CID_MPEG_AUDIO_EMPHASIS         (V4L2_CID_MPEG_BASE+107)
  974. enum v4l2_mpeg_audio_emphasis {
  975.     V4L2_MPEG_AUDIO_EMPHASIS_NONE         = 0,
  976.     V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
  977.     V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17    = 2,
  978. };
  979. #define V4L2_CID_MPEG_AUDIO_CRC         (V4L2_CID_MPEG_BASE+108)
  980. enum v4l2_mpeg_audio_crc {
  981.     V4L2_MPEG_AUDIO_CRC_NONE  = 0,
  982.     V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
  983. };
  984. #define V4L2_CID_MPEG_AUDIO_MUTE         (V4L2_CID_MPEG_BASE+109)
  985.  
  986. /*  MPEG video */
  987. #define V4L2_CID_MPEG_VIDEO_ENCODING         (V4L2_CID_MPEG_BASE+200)
  988. enum v4l2_mpeg_video_encoding {
  989.     V4L2_MPEG_VIDEO_ENCODING_MPEG_1 = 0,
  990.     V4L2_MPEG_VIDEO_ENCODING_MPEG_2 = 1,
  991. };
  992. #define V4L2_CID_MPEG_VIDEO_ASPECT         (V4L2_CID_MPEG_BASE+201)
  993. enum v4l2_mpeg_video_aspect {
  994.     V4L2_MPEG_VIDEO_ASPECT_1x1     = 0,
  995.     V4L2_MPEG_VIDEO_ASPECT_4x3     = 1,
  996.     V4L2_MPEG_VIDEO_ASPECT_16x9    = 2,
  997.     V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
  998. };
  999. #define V4L2_CID_MPEG_VIDEO_B_FRAMES         (V4L2_CID_MPEG_BASE+202)
  1000. #define V4L2_CID_MPEG_VIDEO_GOP_SIZE         (V4L2_CID_MPEG_BASE+203)
  1001. #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE     (V4L2_CID_MPEG_BASE+204)
  1002. #define V4L2_CID_MPEG_VIDEO_PULLDOWN         (V4L2_CID_MPEG_BASE+205)
  1003. #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE     (V4L2_CID_MPEG_BASE+206)
  1004. enum v4l2_mpeg_video_bitrate_mode {
  1005.     V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
  1006.     V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
  1007. };
  1008. #define V4L2_CID_MPEG_VIDEO_BITRATE         (V4L2_CID_MPEG_BASE+207)
  1009. #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK     (V4L2_CID_MPEG_BASE+208)
  1010. #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_MPEG_BASE+209)
  1011. #define V4L2_CID_MPEG_VIDEO_MUTE         (V4L2_CID_MPEG_BASE+210)
  1012. #define V4L2_CID_MPEG_VIDEO_MUTE_YUV         (V4L2_CID_MPEG_BASE+211)
  1013.  
  1014. /*  MPEG-class control IDs specific to the CX2584x driver as defined by V4L2 */
  1015. #define V4L2_CID_MPEG_CX2341X_BASE                 (V4L2_CTRL_CLASS_MPEG | 0x1000)
  1016. #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE     (V4L2_CID_MPEG_CX2341X_BASE+0)
  1017. enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
  1018.     V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
  1019.     V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO   = 1,
  1020. };
  1021. #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER         (V4L2_CID_MPEG_CX2341X_BASE+1)
  1022. #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE     (V4L2_CID_MPEG_CX2341X_BASE+2)
  1023. enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
  1024.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF                  = 0,
  1025.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR               = 1,
  1026.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT              = 2,
  1027.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE      = 3,
  1028.     V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
  1029. };
  1030. #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE     (V4L2_CID_MPEG_CX2341X_BASE+3)
  1031. enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
  1032.     V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF    = 0,
  1033.     V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
  1034. };
  1035. #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE     (V4L2_CID_MPEG_CX2341X_BASE+4)
  1036. enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
  1037.     V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
  1038.     V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO   = 1,
  1039. };
  1040. #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER         (V4L2_CID_MPEG_CX2341X_BASE+5)
  1041. #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE         (V4L2_CID_MPEG_CX2341X_BASE+6)
  1042. enum v4l2_mpeg_cx2341x_video_median_filter_type {
  1043.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF      = 0,
  1044.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR      = 1,
  1045.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT     = 2,
  1046.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
  1047.     V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG     = 4,
  1048. };
  1049. #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM     (V4L2_CID_MPEG_CX2341X_BASE+7)
  1050. #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP     (V4L2_CID_MPEG_CX2341X_BASE+8)
  1051. #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM    (V4L2_CID_MPEG_CX2341X_BASE+9)
  1052. #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP     (V4L2_CID_MPEG_CX2341X_BASE+10)
  1053. #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS     (V4L2_CID_MPEG_CX2341X_BASE+11)
  1054.  
  1055. /*  Camera class control IDs */
  1056. #define V4L2_CID_CAMERA_CLASS_BASE     (V4L2_CTRL_CLASS_CAMERA | 0x900)
  1057. #define V4L2_CID_CAMERA_CLASS         (V4L2_CTRL_CLASS_CAMERA | 1)
  1058.  
  1059. #define V4L2_CID_EXPOSURE_AUTO            (V4L2_CID_CAMERA_CLASS_BASE+1)
  1060. enum  v4l2_exposure_auto_type {
  1061.     V4L2_EXPOSURE_AUTO = 0,
  1062.     V4L2_EXPOSURE_MANUAL = 1,
  1063.     V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
  1064.     V4L2_EXPOSURE_APERTURE_PRIORITY = 3
  1065. };
  1066. #define V4L2_CID_EXPOSURE_ABSOLUTE        (V4L2_CID_CAMERA_CLASS_BASE+2)
  1067. #define V4L2_CID_EXPOSURE_AUTO_PRIORITY        (V4L2_CID_CAMERA_CLASS_BASE+3)
  1068.  
  1069. #define V4L2_CID_PAN_RELATIVE            (V4L2_CID_CAMERA_CLASS_BASE+4)
  1070. #define V4L2_CID_TILT_RELATIVE            (V4L2_CID_CAMERA_CLASS_BASE+5)
  1071. #define V4L2_CID_PAN_RESET            (V4L2_CID_CAMERA_CLASS_BASE+6)
  1072. #define V4L2_CID_TILT_RESET            (V4L2_CID_CAMERA_CLASS_BASE+7)
  1073.  
  1074. #define V4L2_CID_PAN_ABSOLUTE            (V4L2_CID_CAMERA_CLASS_BASE+8)
  1075. #define V4L2_CID_TILT_ABSOLUTE            (V4L2_CID_CAMERA_CLASS_BASE+9)
  1076.  
  1077. #define V4L2_CID_FOCUS_ABSOLUTE            (V4L2_CID_CAMERA_CLASS_BASE+10)
  1078. #define V4L2_CID_FOCUS_RELATIVE            (V4L2_CID_CAMERA_CLASS_BASE+11)
  1079. #define V4L2_CID_FOCUS_AUTO            (V4L2_CID_CAMERA_CLASS_BASE+12)
  1080.  
  1081. /*
  1082.  *    T U N I N G
  1083.  */
  1084. struct v4l2_tuner {
  1085.     __u32                   index;
  1086.     __u8            name[32];
  1087.     enum v4l2_tuner_type    type;
  1088.     __u32            capability;
  1089.     __u32            rangelow;
  1090.     __u32            rangehigh;
  1091.     __u32            rxsubchans;
  1092.     __u32            audmode;
  1093.     __s32            signal;
  1094.     __s32            afc;
  1095.     __u32            reserved[4];
  1096. };
  1097.  
  1098. struct v4l2_modulator {
  1099.     __u32            index;
  1100.     __u8            name[32];
  1101.     __u32            capability;
  1102.     __u32            rangelow;
  1103.     __u32            rangehigh;
  1104.     __u32            txsubchans;
  1105.     __u32            reserved[4];
  1106. };
  1107.  
  1108. /*  Flags for the 'capability' field */
  1109. #define V4L2_TUNER_CAP_LOW        0x0001
  1110. #define V4L2_TUNER_CAP_NORM        0x0002
  1111. #define V4L2_TUNER_CAP_STEREO        0x0010
  1112. #define V4L2_TUNER_CAP_LANG2        0x0020
  1113. #define V4L2_TUNER_CAP_SAP        0x0020
  1114. #define V4L2_TUNER_CAP_LANG1        0x0040
  1115.  
  1116. /*  Flags for the 'rxsubchans' field */
  1117. #define V4L2_TUNER_SUB_MONO        0x0001
  1118. #define V4L2_TUNER_SUB_STEREO        0x0002
  1119. #define V4L2_TUNER_SUB_LANG2        0x0004
  1120. #define V4L2_TUNER_SUB_SAP        0x0004
  1121. #define V4L2_TUNER_SUB_LANG1        0x0008
  1122.  
  1123. /*  Values for the 'audmode' field */
  1124. #define V4L2_TUNER_MODE_MONO        0x0000
  1125. #define V4L2_TUNER_MODE_STEREO        0x0001
  1126. #define V4L2_TUNER_MODE_LANG2        0x0002
  1127. #define V4L2_TUNER_MODE_SAP        0x0002
  1128. #define V4L2_TUNER_MODE_LANG1        0x0003
  1129. #define V4L2_TUNER_MODE_LANG1_LANG2    0x0004
  1130.  
  1131. struct v4l2_frequency {
  1132.     __u32              tuner;
  1133.     enum v4l2_tuner_type  type;
  1134.     __u32              frequency;
  1135.     __u32              reserved[8];
  1136. };
  1137.  
  1138. struct v4l2_hw_freq_seek {
  1139.     __u32              tuner;
  1140.     enum v4l2_tuner_type  type;
  1141.     __u32              seek_upward;
  1142.     __u32              wrap_around;
  1143.     __u32              reserved[8];
  1144. };
  1145.  
  1146. /*
  1147.  *    A U D I O
  1148.  */
  1149. struct v4l2_audio {
  1150.     __u32    index;
  1151.     __u8    name[32];
  1152.     __u32    capability;
  1153.     __u32    mode;
  1154.     __u32    reserved[2];
  1155. };
  1156.  
  1157. /*  Flags for the 'capability' field */
  1158. #define V4L2_AUDCAP_STEREO        0x00001
  1159. #define V4L2_AUDCAP_AVL            0x00002
  1160.  
  1161. /*  Flags for the 'mode' field */
  1162. #define V4L2_AUDMODE_AVL        0x00001
  1163.  
  1164. struct v4l2_audioout {
  1165.     __u32    index;
  1166.     __u8    name[32];
  1167.     __u32    capability;
  1168.     __u32    mode;
  1169.     __u32    reserved[2];
  1170. };
  1171.  
  1172. /*
  1173.  *    M P E G   S E R V I C E S
  1174.  *
  1175.  *    NOTE: EXPERIMENTAL API
  1176.  */
  1177. #if 1
  1178. #define V4L2_ENC_IDX_FRAME_I    (0)
  1179. #define V4L2_ENC_IDX_FRAME_P    (1)
  1180. #define V4L2_ENC_IDX_FRAME_B    (2)
  1181. #define V4L2_ENC_IDX_FRAME_MASK (0xf)
  1182.  
  1183. struct v4l2_enc_idx_entry {
  1184.     __u64 offset;
  1185.     __u64 pts;
  1186.     __u32 length;
  1187.     __u32 flags;
  1188.     __u32 reserved[2];
  1189. };
  1190.  
  1191. #define V4L2_ENC_IDX_ENTRIES (64)
  1192. struct v4l2_enc_idx {
  1193.     __u32 entries;
  1194.     __u32 entries_cap;
  1195.     __u32 reserved[4];
  1196.     struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
  1197. };
  1198.  
  1199.  
  1200. #define V4L2_ENC_CMD_START      (0)
  1201. #define V4L2_ENC_CMD_STOP       (1)
  1202. #define V4L2_ENC_CMD_PAUSE      (2)
  1203. #define V4L2_ENC_CMD_RESUME     (3)
  1204.  
  1205. /* Flags for V4L2_ENC_CMD_STOP */
  1206. #define V4L2_ENC_CMD_STOP_AT_GOP_END    (1 << 0)
  1207.  
  1208. struct v4l2_encoder_cmd {
  1209.     __u32 cmd;
  1210.     __u32 flags;
  1211.     union {
  1212.         struct {
  1213.             __u32 data[8];
  1214.         } raw;
  1215.     };
  1216. };
  1217.  
  1218. #endif
  1219.  
  1220.  
  1221. /*
  1222.  *    D A T A   S E R V I C E S   ( V B I )
  1223.  *
  1224.  *    Data services API by Michael Schimek
  1225.  */
  1226.  
  1227. /* Raw VBI */
  1228. struct v4l2_vbi_format {
  1229.     __u32    sampling_rate;        /* in 1 Hz */
  1230.     __u32    offset;
  1231.     __u32    samples_per_line;
  1232.     __u32    sample_format;        /* V4L2_PIX_FMT_* */
  1233.     __s32    start[2];
  1234.     __u32    count[2];
  1235.     __u32    flags;            /* V4L2_VBI_* */
  1236.     __u32    reserved[2];        /* must be zero */
  1237. };
  1238.  
  1239. /*  VBI flags  */
  1240. #define V4L2_VBI_UNSYNC        (1 << 0)
  1241. #define V4L2_VBI_INTERLACED    (1 << 1)
  1242.  
  1243. /* Sliced VBI
  1244.  *
  1245.  *    This implements is a proposal V4L2 API to allow SLICED VBI
  1246.  * required for some hardware encoders. It should change without
  1247.  * notice in the definitive implementation.
  1248.  */
  1249.  
  1250. struct v4l2_sliced_vbi_format {
  1251.     __u16   service_set;
  1252.     /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
  1253.        service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
  1254.                  (equals frame lines 313-336 for 625 line video
  1255.                   standards, 263-286 for 525 line standards) */
  1256.     __u16   service_lines[2][24];
  1257.     __u32   io_size;
  1258.     __u32   reserved[2];            /* must be zero */
  1259. };
  1260.  
  1261. /* Teletext World System Teletext
  1262.    (WST), defined on ITU-R BT.653-2 */
  1263. #define V4L2_SLICED_TELETEXT_B          (0x0001)
  1264. /* Video Program System, defined on ETS 300 231*/
  1265. #define V4L2_SLICED_VPS                 (0x0400)
  1266. /* Closed Caption, defined on EIA-608 */
  1267. #define V4L2_SLICED_CAPTION_525         (0x1000)
  1268. /* Wide Screen System, defined on ITU-R BT1119.1 */
  1269. #define V4L2_SLICED_WSS_625             (0x4000)
  1270.  
  1271. #define V4L2_SLICED_VBI_525             (V4L2_SLICED_CAPTION_525)
  1272. #define V4L2_SLICED_VBI_625             (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
  1273.  
  1274. struct v4l2_sliced_vbi_cap {
  1275.     __u16   service_set;
  1276.     /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
  1277.        service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
  1278.                  (equals frame lines 313-336 for 625 line video
  1279.                   standards, 263-286 for 525 line standards) */
  1280.     __u16   service_lines[2][24];
  1281.     enum v4l2_buf_type type;
  1282.     __u32   reserved[3];    /* must be 0 */
  1283. };
  1284.  
  1285. struct v4l2_sliced_vbi_data {
  1286.     __u32   id;
  1287.     __u32   field;          /* 0: first field, 1: second field */
  1288.     __u32   line;           /* 1-23 */
  1289.     __u32   reserved;       /* must be 0 */
  1290.     __u8    data[48];
  1291. };
  1292.  
  1293. /*
  1294.  *    A G G R E G A T E   S T R U C T U R E S
  1295.  */
  1296.  
  1297. /*    Stream data format
  1298.  */
  1299. struct v4l2_format {
  1300.     enum v4l2_buf_type type;
  1301.     union {
  1302.         struct v4l2_pix_format        pix;     /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
  1303.         struct v4l2_window        win;     /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
  1304.         struct v4l2_vbi_format        vbi;     /* V4L2_BUF_TYPE_VBI_CAPTURE */
  1305.         struct v4l2_sliced_vbi_format    sliced;  /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
  1306.         __u8    raw_data[200];                   /* user-defined */
  1307.     } fmt;
  1308. };
  1309.  
  1310.  
  1311. /*    Stream type-dependent parameters
  1312.  */
  1313. struct v4l2_streamparm {
  1314.     enum v4l2_buf_type type;
  1315.     union {
  1316.         struct v4l2_captureparm    capture;
  1317.         struct v4l2_outputparm    output;
  1318.         __u8    raw_data[200];  /* user-defined */
  1319.     } parm;
  1320. };
  1321.  
  1322. /*
  1323.  *    A D V A N C E D   D E B U G G I N G
  1324.  *
  1325.  *    NOTE: EXPERIMENTAL API
  1326.  */
  1327.  
  1328. /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
  1329.  
  1330. #define V4L2_CHIP_MATCH_HOST       0  /* Match against chip ID on host (0 for the host) */
  1331. #define V4L2_CHIP_MATCH_I2C_DRIVER 1  /* Match against I2C driver ID */
  1332. #define V4L2_CHIP_MATCH_I2C_ADDR   2  /* Match against I2C 7-bit address */
  1333.  
  1334. struct v4l2_register {
  1335.     __u32 match_type; /* Match type */
  1336.     __u32 match_chip; /* Match this chip, meaning determined by match_type */
  1337.     __u64 reg;
  1338.     __u64 val;
  1339. };
  1340.  
  1341. /* VIDIOC_G_CHIP_IDENT */
  1342. struct v4l2_chip_ident {
  1343.     __u32 match_type;  /* Match type */
  1344.     __u32 match_chip;  /* Match this chip, meaning determined by match_type */
  1345.     __u32 ident;       /* chip identifier as specified in <media/v4l2-chip-ident.h> */
  1346.     __u32 revision;    /* chip revision, chip specific */
  1347. };
  1348.  
  1349. /*
  1350.  *    I O C T L   C O D E S   F O R   V I D E O   D E V I C E S
  1351.  *
  1352.  */
  1353. #define VIDIOC_QUERYCAP         _IOR('V',  0, struct v4l2_capability)
  1354. #define VIDIOC_RESERVED          _IO('V',  1)
  1355. #define VIDIOC_ENUM_FMT         _IOWR('V',  2, struct v4l2_fmtdesc)
  1356. #define VIDIOC_G_FMT        _IOWR('V',  4, struct v4l2_format)
  1357. #define VIDIOC_S_FMT        _IOWR('V',  5, struct v4l2_format)
  1358. #define VIDIOC_REQBUFS        _IOWR('V',  8, struct v4l2_requestbuffers)
  1359. #define VIDIOC_QUERYBUF        _IOWR('V',  9, struct v4l2_buffer)
  1360. #define VIDIOC_G_FBUF         _IOR('V', 10, struct v4l2_framebuffer)
  1361. #define VIDIOC_S_FBUF         _IOW('V', 11, struct v4l2_framebuffer)
  1362. #define VIDIOC_OVERLAY         _IOW('V', 14, int)
  1363. #define VIDIOC_QBUF        _IOWR('V', 15, struct v4l2_buffer)
  1364. #define VIDIOC_DQBUF        _IOWR('V', 17, struct v4l2_buffer)
  1365. #define VIDIOC_STREAMON         _IOW('V', 18, int)
  1366. #define VIDIOC_STREAMOFF     _IOW('V', 19, int)
  1367. #define VIDIOC_G_PARM        _IOWR('V', 21, struct v4l2_streamparm)
  1368. #define VIDIOC_S_PARM        _IOWR('V', 22, struct v4l2_streamparm)
  1369. #define VIDIOC_G_STD         _IOR('V', 23, v4l2_std_id)
  1370. #define VIDIOC_S_STD         _IOW('V', 24, v4l2_std_id)
  1371. #define VIDIOC_ENUMSTD        _IOWR('V', 25, struct v4l2_standard)
  1372. #define VIDIOC_ENUMINPUT    _IOWR('V', 26, struct v4l2_input)
  1373. #define VIDIOC_G_CTRL        _IOWR('V', 27, struct v4l2_control)
  1374. #define VIDIOC_S_CTRL        _IOWR('V', 28, struct v4l2_control)
  1375. #define VIDIOC_G_TUNER        _IOWR('V', 29, struct v4l2_tuner)
  1376. #define VIDIOC_S_TUNER         _IOW('V', 30, struct v4l2_tuner)
  1377. #define VIDIOC_G_AUDIO         _IOR('V', 33, struct v4l2_audio)
  1378. #define VIDIOC_S_AUDIO         _IOW('V', 34, struct v4l2_audio)
  1379. #define VIDIOC_QUERYCTRL    _IOWR('V', 36, struct v4l2_queryctrl)
  1380. #define VIDIOC_QUERYMENU    _IOWR('V', 37, struct v4l2_querymenu)
  1381. #define VIDIOC_G_INPUT         _IOR('V', 38, int)
  1382. #define VIDIOC_S_INPUT        _IOWR('V', 39, int)
  1383. #define VIDIOC_G_OUTPUT         _IOR('V', 46, int)
  1384. #define VIDIOC_S_OUTPUT        _IOWR('V', 47, int)
  1385. #define VIDIOC_ENUMOUTPUT    _IOWR('V', 48, struct v4l2_output)
  1386. #define VIDIOC_G_AUDOUT         _IOR('V', 49, struct v4l2_audioout)
  1387. #define VIDIOC_S_AUDOUT         _IOW('V', 50, struct v4l2_audioout)
  1388. #define VIDIOC_G_MODULATOR    _IOWR('V', 54, struct v4l2_modulator)
  1389. #define VIDIOC_S_MODULATOR     _IOW('V', 55, struct v4l2_modulator)
  1390. #define VIDIOC_G_FREQUENCY    _IOWR('V', 56, struct v4l2_frequency)
  1391. #define VIDIOC_S_FREQUENCY     _IOW('V', 57, struct v4l2_frequency)
  1392. #define VIDIOC_CROPCAP        _IOWR('V', 58, struct v4l2_cropcap)
  1393. #define VIDIOC_G_CROP        _IOWR('V', 59, struct v4l2_crop)
  1394. #define VIDIOC_S_CROP         _IOW('V', 60, struct v4l2_crop)
  1395. #define VIDIOC_G_JPEGCOMP     _IOR('V', 61, struct v4l2_jpegcompression)
  1396. #define VIDIOC_S_JPEGCOMP     _IOW('V', 62, struct v4l2_jpegcompression)
  1397. #define VIDIOC_QUERYSTD           _IOR('V', 63, v4l2_std_id)
  1398. #define VIDIOC_TRY_FMT          _IOWR('V', 64, struct v4l2_format)
  1399. #define VIDIOC_ENUMAUDIO    _IOWR('V', 65, struct v4l2_audio)
  1400. #define VIDIOC_ENUMAUDOUT    _IOWR('V', 66, struct v4l2_audioout)
  1401. #define VIDIOC_G_PRIORITY        _IOR('V', 67, enum v4l2_priority)
  1402. #define VIDIOC_S_PRIORITY        _IOW('V', 68, enum v4l2_priority)
  1403. #define VIDIOC_G_SLICED_VBI_CAP _IOWR('V', 69, struct v4l2_sliced_vbi_cap)
  1404. #define VIDIOC_LOG_STATUS         _IO('V', 70)
  1405. #define VIDIOC_G_EXT_CTRLS    _IOWR('V', 71, struct v4l2_ext_controls)
  1406. #define VIDIOC_S_EXT_CTRLS    _IOWR('V', 72, struct v4l2_ext_controls)
  1407. #define VIDIOC_TRY_EXT_CTRLS    _IOWR('V', 73, struct v4l2_ext_controls)
  1408. #if 1
  1409. #define VIDIOC_ENUM_FRAMESIZES    _IOWR('V', 74, struct v4l2_frmsizeenum)
  1410. #define VIDIOC_ENUM_FRAMEINTERVALS _IOWR('V', 75, struct v4l2_frmivalenum)
  1411. #define VIDIOC_G_ENC_INDEX       _IOR('V', 76, struct v4l2_enc_idx)
  1412. #define VIDIOC_ENCODER_CMD      _IOWR('V', 77, struct v4l2_encoder_cmd)
  1413. #define VIDIOC_TRY_ENCODER_CMD  _IOWR('V', 78, struct v4l2_encoder_cmd)
  1414.  
  1415. /* Experimental, only implemented if CONFIG_VIDEO_ADV_DEBUG is defined */
  1416. #define    VIDIOC_DBG_S_REGISTER      _IOW('V', 79, struct v4l2_register)
  1417. #define    VIDIOC_DBG_G_REGISTER     _IOWR('V', 80, struct v4l2_register)
  1418.  
  1419. #define VIDIOC_G_CHIP_IDENT     _IOWR('V', 81, struct v4l2_chip_ident)
  1420. #endif
  1421. #define VIDIOC_S_HW_FREQ_SEEK     _IOW('V', 82, struct v4l2_hw_freq_seek)
  1422.  
  1423. #ifdef __OLD_VIDIOC_
  1424. /* for compatibility, will go away some day */
  1425. #define VIDIOC_OVERLAY_OLD         _IOWR('V', 14, int)
  1426. #define VIDIOC_S_PARM_OLD           _IOW('V', 22, struct v4l2_streamparm)
  1427. #define VIDIOC_S_CTRL_OLD           _IOW('V', 28, struct v4l2_control)
  1428. #define VIDIOC_G_AUDIO_OLD         _IOWR('V', 33, struct v4l2_audio)
  1429. #define VIDIOC_G_AUDOUT_OLD        _IOWR('V', 49, struct v4l2_audioout)
  1430. #define VIDIOC_CROPCAP_OLD          _IOR('V', 58, struct v4l2_cropcap)
  1431. #endif
  1432.  
  1433. #define BASE_VIDIOC_PRIVATE    192        /* 192-255 are private */
  1434.  
  1435. #endif /* __LINUX_VIDEODEV2_H */
  1436.